Skip to content

Disambiguate see also links - #12932

Merged
gewarren merged 4 commits into
dotnet:mainfrom
gewarren:ambiguous-seealso-non-windows
Aug 5, 2026
Merged

Disambiguate see also links#12932
gewarren merged 4 commits into
dotnet:mainfrom
gewarren:ambiguous-seealso-non-windows

Conversation

@gewarren

@gewarren gewarren commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Fixes #12930.

Copilot AI review requested due to automatic review settings August 4, 2026 19:22
Copilot AI reviewed Aug 4, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR addresses dotnet-api-docs issue #12930 by disambiguating “See also” entries that currently render with ambiguous display text on learn.microsoft.com. It does so by replacing selected <altmember /> references with <seealso> elements that include explicit link text.

Changes:

  • Convert ambiguous “See also” references from <altmember /> to <seealso> with explicit display text across affected API XML files.
  • Apply minor whitespace/formatting cleanup in a small number of affected docs blocks while updating the “See also” list.

Reviewed changes

Copilot reviewed 88 out of 89 changed files in this pull request and generated no comments.

Show a summary per file
File Description
xml/System/UInt64.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System/StringComparison.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System/Char.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xml/ConformanceLevel.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xml.XPath/XPathResultType.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xml.Linq/XElement.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xml.Linq/Extensions.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xaml/XamlReader.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xaml/NamespaceDeclaration.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Xaml/IXamlSchemaContextProvider.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Threading/WaitHandleCannotBeOpenedException.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Text/Encoding.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechRecognizer.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechRecognizedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechRecognitionRejectedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechRecognitionEngine.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechHypothesizedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/SpeechDetectedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/RecognizerUpdateReachedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/RecognitionResult.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/RecognitionEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/LoadGrammarCompletedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/EmulateRecognizeCompletedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/AudioStateChangedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/AudioSignalProblemOccurredEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/AudioSignalProblem.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Speech.Recognition/AudioLevelUpdatedEventArgs.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml Minor whitespace cleanup in docs content while maintaining/aligning formatting.
xml/System.Runtime.InteropServices/UnmanagedFunctionPointerAttribute.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Runtime.CompilerServices/DependencyAttribute.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Runtime.CompilerServices/DefaultDependencyAttribute.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Reflection.Emit/TypeBuilder.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Printing/PrintSystemJobInfo.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/WebUtility.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/WebRequest.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/WebClient.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/ServicePoint.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/IPAddress.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/HttpListenerRequest.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/HttpListener+ExtendedProtectionSelector.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net/HttpListener.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net.Sockets/UdpClient.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net.Sockets/TcpListener.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net.Sockets/Socket.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Net.Sockets/IPProtectionLevel.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.IO/TextWriter.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.IO/TextReader.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.IO/FileShare.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.IO/FileMode.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.IO/File.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/UmAlQuraCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/ThaiBuddhistCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/TaiwanCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/PersianCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/KoreanCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/JulianCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/JapaneseCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/HijriCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/HebrewCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/GregorianCalendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Globalization/Calendar.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Drawing.Printing/PrinterSettings.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices/ActiveDirectoryRights.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/TrustRelationshipInformationCollection.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/TrustRelationshipInformation.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/SyncUpdateCallback.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/SyncFromAllServersOptions.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/SyncFromAllServersOperationException.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/ReplicationNeighbor.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/ApplicationPartitionCollection.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.DirectoryServices.ActiveDirectory/ActiveDirectoryReplicationMetadata.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Diagnostics/StackTrace.xml Clean up remarks formatting and disambiguate “See also” entries via <seealso> text.
xml/System.Diagnostics/EventLog.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Data/PropertyCollection.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Configuration/SpecialSettingAttribute.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Configuration/SettingsSerializeAsAttribute.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.ComponentModel/MaskedTextProvider.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.ComponentModel/ICustomTypeDescriptor.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.ComponentModel/CustomTypeDescriptor.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.ComponentModel.Design/DesignerActionItem.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/Stack`1.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/SortedDictionary`2+ValueCollection+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/SortedDictionary`2+KeyCollection+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/SortedDictionary`2+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/Queue`1.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/LinkedList`1.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/Dictionary`2+ValueCollection+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/Dictionary`2+KeyCollection+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.
xml/System.Collections.Generic/Dictionary`2+Enumerator.xml Disambiguate “See also” entries by switching to <seealso> with explicit text.

adegeo
adegeo approved these changes Aug 4, 2026
View reviewed changes
Comment thread xml/System.Collections.Generic/Dictionary`2+Enumerator.xml Outdated
@gewarren
gewarren merged commit 7a629f2 into dotnet:main Aug 5, 2026
7 checks passed
@gewarren
gewarren deleted the ambiguous-seealso-non-windows branch August 5, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments
@adegeo adegeo adegeo approved these changes
@AaronRobinsonMSFT AaronRobinsonMSFT Awaiting requested review from AaronRobinsonMSFT AaronRobinsonMSFT is a code owner
@jkoritzinsky jkoritzinsky Awaiting requested review from jkoritzinsky jkoritzinsky is a code owner

Assignees

@gewarren gewarren

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

See Also types display text is sometimes ambiguous

3 participants

@gewarren @adegeo